home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / FSELECT.HDR < prev    next >
Text File  |  1994-04-25  |  2KB  |  51 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _FSelect(cAlias) -->lAliasFound
  8.  
  9. PARAMETERS:
  10.  
  11. cAlias : Database Alias to Select
  12.  
  13. SHORT:
  14.  
  15. Select a database by work area alias.
  16.  
  17. DESCRIPTION:
  18.  
  19. _FSelect() will search through all open work areas looking for one with the
  20. alias specified in cAlias.  If an alias is not specifically declared when you
  21. open a file, the file's alias defaults to the file name so you may still find
  22. an area with _FSelect() by specifying the file name for files which you did
  23. not specify an alias.  File Name excludes File Extention!
  24.  
  25. Why use _FSelect() when Clipper's SELECT command will select on an alias
  26. expression?  SELECT will result in a runtime error if the expression is not a
  27. valid alias.  _FSelect() will simply return FALSE if the area is not open or
  28. will select that area if it is.
  29.  
  30. _FSelect() differs from _Select() in that _FSelect() looks specifically for
  31. an ALIAS, whereas _Select() is dual-purpose in nature and can find a work
  32. area by number or by Alias.
  33.  
  34. NOTE:
  35.  
  36.  
  37.  
  38. EXAMPLE:
  39.  
  40. _FSelect('BUDGET')
  41.  
  42. Result: If BUDGET.DBF (or another file opened with the ALIAS BUDGET) is
  43. open anywhere in the envirnoment, it will be selected and will become
  44. the current work area.  Else, the work area that was current before the
  45. call is restored and remains current.
  46.  
  47. The Return Value is a logical indicating whether the alias was found
  48. and selected.  TRUE = Yes.
  49.  
  50. ******************************************************************************/
  51.